home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 25 / AMIGAplus Sonderheft 25 (2000)(Falke)(DE)(Track 1 of 4)[!].iso / Tools / HexED / HexED.doc < prev    next >
Text File  |  2000-05-08  |  19KB  |  501 lines
  1. -----------------------------------------------------------------------------
  2.                              #   # ##### #   #
  3.                              #   # #      # #
  4.                              ##### ###     #
  5.                              #   # #      # #
  6.                              #   # ##### #   #
  7. -----------------------------------------------------------------------------
  8.  
  9.                       Hex V1.0, Copyright (c) 1990 by
  10.  
  11.                              Nicola Salmoria
  12.                              Via Piemonte 11
  13.                              53100 Siena  ITALY
  14.  
  15.                             All rights reserved.
  16.  
  17.  
  18. You can contact me on:
  19. MC-Link:      +39 6 4180440      my code is MC6489
  20.  
  21. Voice:        +39 577 54164
  22.  
  23. You can try to contact me on FidoNet, but it's unlikely you'll get an answer,
  24. 'cos there's yet no Fido node in Siena. Maybe in the future.
  25.  
  26.  
  27. This program is SHAREWARE. Copy it as much as you can (provided no charge is
  28. made and the archive is left intact). It can be included, with the same
  29. restrictions, in any commercial program without the written permission of the
  30. author.
  31. Contributions will be greatly appreciated and will help me support Hex in the
  32. future as well as develop new programs. Suggested contribution is $15.
  33. Hex development took 4 months. I spent much time in it, and I'd like to be
  34. rewarded for my work.
  35. Keep one thing in mind: I will probably add new features to Hex, but I will NOT
  36. release a new version until I get enough feedback. So you know what to do.
  37.  
  38.  
  39.  
  40. IMPORTANT NOTE: Hex has some unique features difficult to understand or to
  41. even know about without reading this doc file. If you're too lazy to read it
  42. all, you should read at least the 'Editing & keyboard' chapter, plus the
  43. explanations of the menu items you don't understand.
  44.  
  45. WARNING: This program in the wrong hands may be a lethal weapon! Use at your
  46. own risk. Anyway, Hex is provided "AS IS", without warranty of any kind, either
  47. expressed or implied. The author will never be liable for any loss of data,
  48. disk damage, computer explosion, earthquake, alien invasion, or anything else.
  49.  
  50. REMEMBER: It is both immoral and illegal to modify someone else's programs
  51. and redistribute them. All such changes should be considered strictly for
  52. personal use. If you want to let the rest of the world know about some nice
  53. changes you've devised, I think it may be considered acceptable to spread a text
  54. file explaining what to change (like I do with keymaps later on).
  55.  
  56.  
  57.  
  58. --------
  59. Overview
  60. --------
  61.  
  62. Hex is a file-based (as opposed to sector-based, like NewZAP) binary file
  63. editor. This means that the file is loaded in memory all at once, edited
  64. there and saved at the end. There are advantages and disadvantages in both
  65. approaches: sector-based editors heavy depend on device speed in operations
  66. like search; on the other hand, file based-ones take longer to display the
  67. file for the first time, 'cos they have to load it all. Moreover, file-based
  68. editors need more memory, and it may be impossible to load very large files.
  69. Hex uses the same text routines of MiniView80. This means it's got (one of)
  70. the fastest and smoothest screen rendering ever seen in a file editor.
  71.  
  72.  
  73.  
  74. ---------------
  75. Acknowledgement
  76. ---------------
  77.  
  78. I'd like to thank the following people for beta-testing and suggestions:
  79.  
  80. Federico Giannici
  81. Marco Ciuchini
  82. Antonio Rossi
  83. Massimiliano Marras
  84. Angelo Mariani
  85.  
  86.  
  87.  
  88. -------
  89. Loading
  90. -------
  91.  
  92. From WorkBench, double-click on Hex icon. You can use extended selection: click
  93. on Hex icon, then press SHIFT and double-click on the file icon.
  94.  
  95. From CLI, syntax is:
  96. Hex [filename] [NODETACH]
  97. If you specify a file name, it will be loaded on startup.
  98. By default, Hex detaches from the current CLI. You can disable this feature
  99. with the switch NODETACH. It may be useful if you execute Hex from one of that
  100. nice directory utilities.
  101.  
  102. IMPORTANT NOTE: To load Hex, the file 'req.library' must be in your LIBS:
  103. directory. Req.library is a freely distributable library by C.W.Fox and
  104. Bruce Dawson. If you are a programmer, you may want to take a look at it:
  105. it features the BEST file requester I have ever seen and many other nice
  106. functions.
  107.  
  108.  
  109.  
  110. -----------
  111. The gadgets
  112. -----------
  113.  
  114. Many hex functions are obtained thru the use of gadgets. Most of them can be
  115. operated also with menus. Of course selecting a menu is less handy than directly
  116. clicking in a gadget; menu operations are there mostly to provide keyboard
  117. shortcuts.
  118.  
  119. Search gadgets:
  120. ---------------
  121. In the 'Search' box there are many gadgets, all obviously related to the search
  122. functions. There are three boxes near to the words 'Search', 'Hex', 'Text'. Only
  123. one of them is selected, and indicates which search mode is currently active.
  124. You can click on them to quickly change search mode.
  125. If a match is found, cursor is placed at the start of it, and edit mode is
  126. changed to the corresponding one.
  127.  
  128. String
  129.          Search for a given string. Click in the string gadget below and enter
  130.          the text you want to search for. When you press return, search will
  131.          start at cursor position.
  132.  
  133. A=a
  134.          Search can be case sensitive or case unsensitive; you can switch the
  135.          flag with this gadget.
  136.  
  137. Hex
  138.          Search for a sequence of bytes you specify via their hexadecimal
  139.          notation. Click in the string gadget below and enter the byte sequence
  140.          you want to search. You can enter data as xx xx xx, xxxxxxxx, xxxx xx
  141.          xxxxxx, anyway you want, provided between two blank spaces there is an
  142.          even number of characters.
  143.  
  144. CAL
  145.          Imports in the hex gadget the value currently displayed on the
  146.          calculator display. A leading zero is added if needed.
  147.  
  148. Text
  149.          This is a special feature: it searches the file for occurrencies of at
  150.          least eight 'good' ASCII characters. It is useful to quickly locate
  151.          message strings in a file. When this box is selected, use 'Continue' to
  152.          scan the file.
  153.  
  154. Continue
  155.          Continues the search from the new cursor position.
  156.  
  157. << and >>
  158.          Specify the search direction.
  159.  
  160.  
  161. Other gadgets:
  162. --------------
  163. Start and End
  164.          These two behave differently if you are editing a file or GRABbing
  165.          memory (see below). In file mode, 'Start' is always zero and 'End'
  166.          indicates the last byte of the file (or, if you prefer, the file length
  167.          MINUS ONE). In memory mode, they indicate the start and end of the
  168.          memory grabbed. You can change the value contained in these gadgets:
  169.          the file will be modified accordingly, if possible. You can enlarge or
  170.          shrink a file, or change the 'window' on the memory. To add bytes at
  171.          the start of the file, simply insert a negative value. Note that when
  172.          you change the 'Start' gadget in file mode, it is reset to zero and the
  173.          'End' value is changed accordingly.
  174.          If you press SHIFT-Return in one of the gadgets, the other one is
  175.          activated. This is an easy way to change start and end together. It's
  176.          main use is to completely change the portion of memory grabbed.
  177.  
  178. Position
  179.          Reports the position occupied by the cursor in the file. Modify its
  180.          value to jump to a specific location.
  181.  
  182. Editing
  183.          Shows which side of the display you are editing: ASCII or HEX. This
  184.          gadget exists only in 'Hex/ASCII' display mode, in 'Only ASCII' it is
  185.          replaced by 'Value', which reports the hex value of the byte the cursor
  186.          is on. You can modify this value, so you don't have to change the
  187.          display mode to insert an hex value in the middle of an ASCII string.
  188.  
  189. UNDO and REDO
  190.          Self explainatory. Hex features a multi-level undo/redo (currently max
  191.          undo level is 256).
  192.  
  193.  
  194.  
  195. ---------
  196. The menus
  197. ---------
  198.  
  199. NOTE: I won't repeat it for every function, but every time you do something
  200. which would mean losing the current data, a requester will appear asking if you
  201. want to save the file, continue anyway, or cancel the operation.
  202.  
  203. Project:
  204. --------
  205. About
  206.          The usual information about the program.
  207.  
  208. New
  209.          Creates a new file. The current file is cleared, and the gadget 'End'
  210.          is activated.